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Introduction
This document provides a detailed overview of the Assisted Installer implementation for the ocp_neptune application. The Assisted Installer is a user-friendly installation solution that simplifies the deployment of OpenShift clusters, focusing on bare metal installations but also supporting other platforms. It is available in ACM as a component of MCE, requiring no separate installations.

What is Assisted Installer?
The OpenShift Assisted Installer simplifies the deployment of OpenShift clusters by automating the provisioning, configuration, and deployment processes.

Components:

Assisted Service: Hosts installation artifacts, provides UI or REST API for host discovery, and manages boot processes for the hosts forming the cluster.
Assisted Installer: Provisions new bare metal machines and creates OpenShift clusters. It automates the installation process after host discovery.
Why Assisted Installer?
Automation: Automates provisioning, configuration, and deployment.
Validation: Ensures all prerequisites are met for successful installation.
Automated Discovery: Uses ISO to discover and register hosts.
No Bootstrap Node: Runs on a cluster node, eliminating the need for a separate bootstrap node.
SNO Support: Allows for minimalistic deployments.
Efficiency: Streamlines deployment and management, ensuring consistency and reducing manual efforts.
How Assisted Installer is Configured
Assisted Installer is configured via ACM on ACM Hub with a new application ocp_neptune introduced in ecs_acm_config.

Key Components:

Application: ocp_neptune for AI with policies and subscriptions.
Placement: Applied only on the hub cluster.
ACM Subscriptions:
ocp-neptune-subscription: Applies AI policies on the hub.
ocp-neptune-rack-rlab-subscription: Syncs rack resources from the ocp_neptune_vars repo.
Rack CRD: Holds rack configurations, including network details, BMC IP, MAC addresses, and hostnames.
ACM Policies:
assisted_installer_config: Manages objects and resources required for AI configuration.
assisted_installer_pipelines: Tekton tasks and pipelines for cluster deployment lifecycle.
Detailed Configuration Components
1. Agent Service Configuration:

Purpose: Configuration for Assisted Service deployment, including OS images used for discovery ISOs.
Details: Specifies storage requirements, mirror registry, and OS images like https://artifactrepository.citigroup.net/artifact/generic-gcs-infra-local/redhat/openshift/4.12.33/rhcos-live-rootfs.x86_64.img.
2. Cluster ImageSet:

Purpose: Specifies the release image for cluster installation.
Details: Defines images such as docker-enterprise-prod-local.artifactrepository.citigroup.net/cate-citisystems-openshift/openshift:4.12.33-x86_64.
3. InfraEnv:

Purpose: Manages host inventory with bare metal hosts.
Example Rack CR:
plaintext
Copy code
apiVersion: rack.ecs.citi.io/v1alpha1
kind: rack
metadata:
  name: rlab-l146-upi-3
  namespace: acm-config
spec:
  datacenter: rlab
  dns_domain: namdev.nsrootdev.net
  hardware_vendor: dell
  machines:
    - bmc_ip: 10.40.220.88
      host_mac1: 10:70:FD:4E:37:2C
      host_mac2: 
      name: englabctl11466
  overlays:
    sn_gateway: 10.40.229.1
    sn_length: 25
    subnet: 10.40.229.0
  tims_rest_url: https://10.40.32.210:7443/tims/rest
Pre-requisites for Cluster Deployment
Below are the pre-requisites for running the Tekton pipelines:

Hardware: RAID configuration on hosts.
Credentials: Update default pipeline account, create secrets (ai-pull-secret, ipam-secret) in acm-config.
Access: Write access to repositories (ocp_neptune_vars, ocp_neptune_racks, ocp_neptune_clusters, ecs_lab_acm_managedclusters).
Repositories:

ocp_neptune_vars: Repo for rack variables watched by ocp_neptune_rack_subscription.
ocp_neptune_racks: Repo for InfraEnv manifests.
ocp_neptune_clusters: Repo for cluster manifests.
ecs_lab_acm_managedclusters: Managed cluster and klusterlet YAML files after cluster build.
Assisted Installer Workflow
The workflow for bare metal builds leveraging Tekton and ACM Assisted Installer is as follows:

Create Rack Definition: Define the rack in the BitBucket repository.
Generate ACM Bare Metal Configs: Generate the necessary configurations in Tekton pipelines.
Input Cluster to Join Host List Generated: Add new or scale clusters.
Cluster Config Applied to ACM: Apply the cluster configuration from BitBucket to ACM.
Hosts Bootstrapped to ACM: Bootstrapped hosts are added to the cluster and managed by ACM.
ACM Subscriptions for ocp_neptune
Subscription 1: ocp-neptune-subscription

Purpose: Manage the subscription for the ocp_neptune application.
Details:
Namespace: acm-config
Channel: acm-config/ocp-neptune-channel
Placement Rule: ocp-neptune-placementrule
Annotations: Includes cluster admin rights, git current commit, and hosting subscription details.
Labels: Links to the ocp_neptune application.
Subscription 2: ocp-neptune-rack-rlab-subscription

Purpose: Manage the subscription for the rack variables specific to ocp_neptune.
Details:
Namespace: acm-config
Channel: acm-config/ocp-neptune-rack-channel
Placement Rule: ocp-neptune-rack-rlab-placement
Annotations: Includes GitHub branch and path details.
Labels: Links to the ocp_neptune application.